package com.cykj.shop.service;

import com.cykj.shop.domain.BsDeliveryFeeRule;
import com.cykj.shop.domain.dto.DeliveryFeeRuleDto;

import java.math.BigDecimal;
import java.util.List;

/**
 * 配送费规则Service接口
 * 
 * @author cykj
 * @date 2025-01-20
 */
public interface IDeliveryFeeRuleService {
    
    /**
     * 查询配送费规则列表
     * 
     * @param rule 配送费规则查询条件
     * @return 配送费规则集合
     */
    List<BsDeliveryFeeRule> selectDeliveryFeeRuleList(BsDeliveryFeeRule rule);
    
    /**
     * 根据ID查询配送费规则
     * 
     * @param id 配送费规则ID
     * @return 配送费规则
     */
    BsDeliveryFeeRule selectDeliveryFeeRuleById(Long id);
    
    /**
     * 根据商家ID查询配送费规则列表
     * 
     * @param shopId 商家ID
     * @return 配送费规则集合
     */
    List<BsDeliveryFeeRule> selectDeliveryFeeRuleByShopId(Long shopId);
    
    /**
     * 根据商家ID查询启用的配送费规则
     * 
     * @param shopId 商家ID
     * @return 配送费规则
     */
    BsDeliveryFeeRule selectActiveDeliveryFeeRuleByShopId(Long shopId);
    
    /**
     * 新增配送费规则
     * 
     * @param ruleDto 配送费规则
     * @return 结果
     */
    int insertDeliveryFeeRule(DeliveryFeeRuleDto ruleDto);
    
    /**
     * 修改配送费规则
     * 
     * @param ruleDto 配送费规则
     * @return 结果
     */
    int updateDeliveryFeeRule(DeliveryFeeRuleDto ruleDto);
    
    /**
     * 删除配送费规则
     * 
     * @param id 配送费规则ID
     * @return 结果
     */
    int deleteDeliveryFeeRuleById(Long id);
    
    /**
     * 批量删除配送费规则
     * 
     * @param ids 需要删除的配送费规则ID
     * @return 结果
     */
    int deleteDeliveryFeeRuleByIds(Long[] ids);
    
    /**
     * 启用配送费规则（会禁用该商家的其他规则）
     * 
     * @param id 配送费规则ID
     * @return 结果
     */
    int enableDeliveryFeeRule(Long id);
    
    /**
     * 禁用配送费规则
     * 
     * @param id 配送费规则ID
     * @return 结果
     */
    int disableDeliveryFeeRule(Long id);
    
    /**
     * 计算配送费
     * 
     * @param shopId 商家ID
     * @param distance 配送距离(公里)
     * @return 配送费
     */
    BigDecimal calculateDeliveryFee(Long shopId, BigDecimal distance);
    
    /**
     * 检查规则名称是否已存在
     * 
     * @param ruleId 规则名称
     * @param shopId 商家ID
     * @param excludeId 排除的规则ID（用于更新时检查）
     * @return 是否存在
     */
    boolean checkRuleNameExists(String ruleId, Long shopId, Long excludeId);
}
